home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 July / Macworld (1999-07).dmg / Shareware World / Maths & Science / MacDoppler_v3.8.7 / ReadMe < prev    next >
Text File  |  1999-04-30  |  19KB  |  384 lines

  1. MacDoppler Version 3
  2.  
  3. MacDoppler will read in the Keplerian elements (in either format), calculate the position and relative velocity of the Satellite you are tracking and automatically adjust the Doppler shift on both transmit and receive as well as pointing your antennas.
  4.  
  5. Without registering, the application will run for 10 minutes and track the satellite(s) you choose and display the proper Doppler corrected frequencies that can be entered manually in any rig. When registered with AMSAT ($50.00 US) MacDoppler will connect to your radio and rotor controller through any two serial ports and make the corrections for you once a second. 
  6.  
  7. A Track List Dialog allows you to track up to 8 satellites automatically.
  8.  
  9. Supported Satellites and modes include: MIR Simplex, split, UHF Safex repeater and UHF QSO, AO-27, AO-10, FO-20 and FO-29. In accordance with common practice, in mode JA, the up link (lower) frequency is pegged and the Doppler correction for both transmit and receive is applied to the receive (down link) frequency. Conversely, in mode B the down link (lower) frequency is pegged and the Doppler correction for both transmit and receive is applied to the transmit (up link) frequency. You may also select 'Full Doppler Tuning' from the Options menu to select Doppler adjustments to be made for both the up link and the down link even when in Mode JA or Mode B - this keeps the frequencies stable with respect to the transponder and no drifting through the transponder will occur. This is useful for QSO's with more than two geographical locations - but of course, all operators engaged in the QSO must be using the same method.
  10.  
  11. For FM repeater operation (Mir SAFEX Repeater), FM Simplex (AO-27 or Mir), the PacSats, or Mode JD (fixed), Doppler adjustments are made for both the up link and the down link frequencies.
  12.  
  13. MacDoppler features full predictive dead spot crossing so that a pass is never interrupted by the beam heading passing a southern dead spot.
  14.  
  15. A slider control allows you to sweep the VFO through the transponder range while the transmit frequency tracks the receive frequency. When you hear something interesting, MacDoppler continues to track the frequency through the Doppler changes.
  16.  
  17.  
  18. Revision History:
  19.  
  20. v2.0.0    05/Jun-97  Azimuth & elevation control for the Yaesu G-5400B rotor 
  21.                      (with the GS-232 interface) has been added.
  22. v2.0.1    25/Jun/97  Map added.
  23. v2.0.2    30/Jun/97  Ground track and coverage oval added. Offscreen Gworld
  24.                      and preferences file added.
  25. v2.0.3    28/Jul/97  Better display of coverage area, tested with MacOS 8,
  26.                      Full Doppler Tuning
  27.                      added under the Options menu.
  28. v2.0.4    10/Sep/97  General speed-up, added '.FPU' 68k version.
  29. v2.0.5    11/Sep/97  Fixed Simplex Doppler TX Freq.
  30. v2.0.6    17/Sep/97  Speech and Southern Crossing added.
  31. v2.0.7    19/Oct/97  Better handling of Southern Crossing added.
  32.                      (Thanks for the suggestion Lou)
  33. v2.0.8    20/Oct/97  Southern Crossing bug fixed.
  34. v2.0.9    26/Oct/97  Better AppleEvent Handling.
  35.                      Close 'site.dat' when done with it.
  36. v3.0b1    24/Nov/97  Added support for Endeavour AutoTracker  (Rotor Control Only).
  37. v3.0b2    26/Dec/97  Added Ham Pageing for AOS and LOS and 10 minute warnings.
  38.                      Added full predictive deadspot crossing (Thanks again Lou).
  39.                      Added 'ParkAzEl' to 'site.dat' for parking rotor at
  40.                      user-selectable az & el.
  41. v3.0b3    08/Jan/98  Support added for AOR AR-3000A (receive) (Set RS-232 to
  42.                      9600 baud).
  43. v3.0b4    16/Feb/98  Show all the visible satellites as outline text in the menu.
  44.                      Test for the presense of the Speech Manager.
  45. v3.0b5    23/Feb/98  Site .dat moved to 'Site Info..." dialog.
  46.                      Default Latitude & Longitude taken from 'Map' Control Panel
  47.                      settings.  
  48. v3.0b6    01/Mar/98  Frequency Slider added for quickly scanning through the
  49.                      transponder range. Transmit frequency will track received
  50.                      when 'TLock' is active. MacOS 8 (Appearance Manager) only.
  51. v3.0b7    02/Mar/98  Slider bug fixes.
  52. v3.0b8    02/Mar/98  Harmonize Longitude readouts.
  53. v3.0b9    03/Mar/98  Update Bug.
  54. v3.1b1    15/Mar/98  Support for AutoTracker Radio Control.
  55.                      Support for ICOM 821-H.
  56.                      Support for 9600 Baud FSK PacSats.
  57. v3.1b2    21/Mar/98  Allow more than one copy of MacDoppler to run on the same Mac.
  58.                      Support for Frequency Slider on MacOS 7.6.1
  59.                      if appearance manager installed.
  60. v3.1      27/Mar/98  Release.
  61. v3.1.1    28/Mar/98  Fix minimum elevation degrees.
  62. v3.2      27/Apr/98  FT-847 Support & AutoTracker fixes.
  63. v3.2.1    14/May/98  Debug Log added & AutoTracker fixes.
  64.                      Better prediction of next PacSat.
  65.                      Extended the look-ahead time to 12 hours (4 on 68k machines).
  66.                      FPU version supplied in addittion to the FAT Binary.
  67. v3.2.2    18/May/98  Site Location bug.
  68. v3.2.3    19/May/98  Better handling of satellite switching
  69.                      FPU version quit bug.
  70. v3.2.4    24/May/98  Ground coverage circle for slower 68k machines.
  71.                      Ground coverage circle can be turned on/off in option menu.
  72. v3.2.5    02/Jun/98  Added 'Maximum Elevation' prediction.
  73.                      Added support for Icom IC-275/475 Transceiver pair.
  74.                      Added support for 'EasyCom'.
  75.                      DebugLog supports 2 way I/O traffic.
  76.                      Added look-ahead Support for the FujiSats (FO-20, FO-29).
  77. v3.2.6    03/Jun/98  Support for Icom 820H.
  78. v3.2.7    05/Jun/98  Check for Serial Tool.
  79. v3.2.8    06/Jun/98  'Next Satellite' bug fixed.
  80.                      IC-820H changed to 9600 baud.
  81. v3.2.9    08/Jun/98  Fixes to EasyComm driver.
  82.                      Site Altitude bug fixed.
  83. v3.3.0b1  10/Jun/98  Split radio and rotor debug logs.
  84.                      Fixed prediction bug in 68k & fpu version.
  85.                      Added support for KLM/Mirage rotor controller.
  86. v3.3.0b2  10/Jun/98  EasyCom fixes.
  87.                      Added cmodes: MODE_JA_CW, MODE_B_CW & MODE_A_CW.
  88.                      Added full mode B support for Yaesu FT-847.
  89. v3.3.0b3  11/Jun/98  CW Mode Display bug fixed.
  90.                      Mode.dat updates to FO-20 & FO-29, (channel 7 is CW).
  91.                      FT-847 set CAT mode bug.
  92. v3.3.0b4  11/Jun/98  FT-847 set SAT mode bug.
  93. v3.3.0b5  12/Jun/98  Use keyboard Up/Down Right/Left arrows for tuning
  94.                      Make frequency display more responsive.
  95. v3.3.0b6  12/Jun/98  Make tuning more responsive.
  96. v3.3.0b7  12/Jun/98  Added support for transverter offsets up and down.
  97. v3.3.0b9  12/Jun/98  Fixed CW tracking bug.
  98. v3.3.0b10 13/Jun/98  Maintain TXOffset and RXOffset when 'sliding'.
  99. v3.3.0b11 13/Jun/98  Slider Bug Fix.
  100. v3.3.0    15/Jun/98  Release.
  101. v3.4.b1   20/Jun/98  Use Option key to make slider do uplink only when TLock off.
  102.                      'Pass:' was showing time to Maximum Elevation instead of
  103.                      time to AOS.
  104. v3.4.0    22/Jun/98  Prohibit < -5 degrees for minimum site elevation, Release.
  105. v3.4.1b1  28/Jun/98  10 Hz increments (command key) added.
  106. v3.4.1b2  28/Jun/98  Increased inter-command delay from 33 ms to 50 ms.
  107.                      AutoTracker mod.
  108. v3.4.1b3  28/Jun/98  AutoTracker 250 ms delay after radio commands. 
  109. v3.4.1b4  29/Jun/98  Added decimal degrees elevation to speech and paging.
  110. v3.4.1    03/Jul/98  Release.
  111. v3.4.2b1  04/Jul/98  Change Azimuth to red when sat is visible.
  112.                      Clean up azimuth and elevation display gauges.
  113.                      Memory Leak in About Dialog fixed.
  114.                      Put Satellite name in Window Title.
  115. v3.4.2    08/Jul/98  Release.
  116. v3.4.3    10/Aug/98  Added TMSAT-1 to PacSats look ahead.
  117.                      Save preferences each time Satellite is changed.
  118.                      Y2K Fix.
  119. v3.4.4    18/Aug/98  68k pref save bug fixed.
  120.                      Added fully editable Satellite Track List.
  121. v3.4.5b1  10/Sep/98  Minor changes to Ham Pageing.
  122.                      Prevent the same port being choosen for Radio and Rotor.
  123. v3.4.5    20/Sep/98  All offsets saved in the preferences.
  124. v3.4.6    21/Sep/98  Active Channel number for each sat saved in the preferences.
  125. v3.4.7    22/Sep/98  Beacon offsets for each sat saved in the preferences.
  126. v3.4.8    22/Oct/98  Rebuilt with CodeWarrior Pro release 4. (Faster Code)
  127.                      Catch-22 with 2 serial ports mutually disabling the selection
  128.                      of the other bugfix.
  129.                      Optional rotor parking.
  130. v3.4.9    27/Oct/98  Memory Leak fixed.
  131. v3.5.0    28/Oct/98  Sunlight option added (Earth illumination display).
  132. v3.5.1    03/Nov/98  Added red circle for Sun Sub Point.
  133.           03/Nov/98  Workaround for Icom in-band problem.
  134.           18/Nov/98  Fixed Maximum Elevation Prediction bug.
  135. v3.6.0    14/Dec/98  Zoom Map about site location.
  136. v3.6.1b1  17/Dec/98  Fix Button Hiliting.
  137. v3.6.1    28/Dec/98  Add 'Predictions' file output.
  138. v3.6.2    16/Jan/99  Improved performance for 68k & fpu versions, Added Map Styles.
  139. v3.6.3    07/Feb/99  Added 'Indigo' Map Style.
  140.                      Added chiselled button numbers and Native PPC CDEF
  141.                      Added display of multiple satellites on map.
  142. v3.6.4    12/Feb/99  Allow Scaling of Map.
  143. v3.6.5    14/Feb/99  Enhanced track list data display when scaled out.
  144. v3.6.6    17/Feb/99  Bug Fixes and 30 minute time limit for unregistered demo.
  145. v3.7.0    20/Feb/99  New 'Azure' Map. Better Map Scaling.
  146.                      1 second prediction resolution (PPC).
  147. v3.7.1    22/Feb/99  Slider Update bug fixed.
  148. v3.7.2b1  26/Feb/99  Added 'Tracking' button/indicator.
  149.                      Progress Dialog added for 'Predictions'.
  150.                      Change ground coverage colour when sat is visible.
  151.                      'BetweenPasses' and 'OnExit' modes added.
  152.                      'CAT' button fixed.
  153. v3.7.2    27/Feb/99  Smoothed track lines and coverage circles (round-off error).
  154. v3.7.3    27/Feb/99  Fixed prediction bug, added 'Fiesta' Map.
  155. v3.7.4    27/Feb/99  Better performance on 68k machines.
  156. v3.7.5    28/Feb/99  Southern Dead SpotCrossing bug fixed.
  157.                      Northern/Southern Dead Spot Option added.
  158.                      Predictions bug fixed.
  159. v3.7.6    04/Mar/99  Add grow icon.
  160.                      2-line keps reader bug fixed for Ron Parise's Mir Keps.
  161.                      Support for 'hot-swapping' of screen pixel depth.
  162.                      New Icon Family.
  163.                      Missing 'SpeechLib' no longer a fatal error.
  164. v3.8.0    12/Mar/99  Better checks for speech manager.
  165.                      Corrected initial window size.
  166.                      Fixed list double display bug in Track List Dialog.
  167.                      Added 'proximity' hilighting to Track List Dialog PopUps.
  168.                      Improved map style colours.
  169.                      Improved coverage circle shading.
  170.                      Allow selections from the on screen track list.
  171.                      Added 'Fast Forward' option.
  172. v3.8.1    25/Mar/99  Calico map replaced with Hi Rez map.
  173.                      Apple Menu bug fixed.
  174. v3.8.2    02/Apr/99  HiRez changed to 'Moss' map, 'Slate' added.
  175.                      Preferred memory partition increased to 6mb for 'millions'
  176.                      of colors.
  177.                      Low memory warning alert added.
  178. v3.8.3    02/Apr/99  Config & TrackList popup bug fixed.
  179. v3.8.4    07/Apr/99  Speech bug fixed. Decrease memory footprint.             
  180. v3.8.5    18/Apr/99  'Between Passes' VFO set bug fixed.
  181.                      Save Map SnapShot PICT added to file menu.
  182.                      Need to re-enter your registration number with this version.
  183.                      Preferences not saved with unregistered copy.
  184.                      Display coverage area as well as circle for tracked sats (PPC).
  185.                      Display Altitude of tracked sats.
  186.                      Keps emailed from AMSAT can now be used un-edited.
  187.                      Fixed several Dialog memory leaks.
  188. v3.8.6    20/Apr/99  TrackList Dialog pop-up bug fixed.
  189.                      Continue tracking calculations while dialogs are displayed.
  190. v3.8.7    30/Apr/99  Memory leak in TrackList dialog fixed.
  191.                      Keplerian Editor added under the 'File' menu.
  192.                      Satellite channel offsets now saved by name so that changing
  193.                      order in kepler.dat won't affect offsets or TrackList.
  194.                      Added 'Reload Keps' to File menu.
  195.                      Continue displaying satellites while dialogs are displayed.
  196.  
  197.  
  198. Radio Set Up:
  199.  
  200. IC-820H       9600 baud, default address 0x42, SATL-R(UHF on left for FO & PacSats).
  201. IC-821H       9600 baud, default address 0x4c, SATL-R(UHF on right for AO-10).
  202. FT-736R       4800 baud. UHF downlink for FO & PacSats,VHF downlink for AO-10
  203. FT-847        9600 baud.
  204. AOR3000A      9600 baud.
  205. IC-275/IC-475 1200 baud. default address 0x10/0x14
  206.  
  207.  
  208. Rotor Set Up:
  209.  
  210. GS-232        9600 baud.
  211. AutoTracker   9600 baud.
  212. EasyCom       9600 baud.
  213. KLM/Mirage    2400 baud.
  214.  
  215.  
  216. Quirks:
  217.  
  218. Due to a problem with the 736-R (see note in 736-R manual page 36 bottom left) you may have to take MacDoppler out of CAT mode, press the REV key on the 736R front panel, and return to CAT mode when switching between mode U/V and V/U in Full Duplex, for example: switching from FO-20 to AO-10 and back.
  219.  
  220. The SAT switch must be in one of the full duplex positions for this to work.
  221.  
  222. Alternately, you could take MacDoppler out of CAT mode, use the VFO buttons to switch from U/V to V/U, and then turn CAT mode back on - this will only work if you have one VFO set to U/V and the other VFO set to V/U.
  223.  
  224. On the Icom IC-821H you have to push the 'M/S' button when switching from U/V
  225. to V/U (eg from FO-20 to AO-10).
  226.  
  227. Yaesu Radios support CAT controlled in-band odd splits for doppler correction of uplink and downlink while the Icom radios do not.
  228.  
  229.  
  230.  
  231. Requirements:
  232.  
  233. MacDoppler requires an Apple Macintosh II or faster (some features only supported on Power PC), 1.5 MB of RAM (over and above the OS), System 7.6.1 or later (MacOS 8 required for the Frequency Slider to work). The Application is FAT Binary. Without registering, the application will run for 30 minutes and track the satellite(s) you choose and display the proper Doppler corrected frequencies that can be entered manually in any rig. If you register, MacDoppler will connect to your radio and rotor controller through any two serial ports and make the corrections for you once a second.
  234.  
  235.  
  236. Supported Equipment:
  237.  
  238. Yaesu FT-736R Transceiver
  239.   with FIF-232 Level Converter or Endeavour AutoTracker
  240.  
  241. YAESU FT-847 Transciever
  242.   direct RS-232
  243.  
  244. ICOM IC-275/IC-475 Transceiver pair
  245.   with CT-17 Level Converter
  246.  
  247. ICOM IC-820H  Transceiver 
  248.   with CT-17 Level Converter or Endeavour AutoTracker
  249.  
  250. ICOM IC-821H  Transceiver 
  251.   with CT-17 Level Converter or Endeavour AutoTracker
  252.  
  253. AOR A3000A Receiver
  254.   direct RS-232
  255.  
  256. Yaesu G-5400B Elevation-Azimuth Dual Controller
  257.   with GS-232 Computer Controller or Endeavour AutoTracker
  258.  
  259. KLM/Mirage Controller
  260.  
  261.  
  262. Tracker Protocols Supported:
  263.  
  264.   Endeavour AutoTracker
  265.   EasyCom
  266.  
  267.  
  268.  
  269. Buttons:
  270.  
  271.     'CAT':        Turns the Radio Control system on and off (Registered version only)
  272.  
  273.     'Beacon':     Switches to/from the beacon frequency in mode.dat for that satellite.
  274.  
  275.     '1..8':       Switches amongst the 8 frequencies and modes for that satellite.
  276.                (use with shift key to decrease mode number).
  277.                (can also use 'Right/Left Arrows' on keyboard)
  278.  
  279.     '/\'                            (Up Arrow) Move rx up 100 Hz
  280.                                              (use with shift key to make it 1kHz)
  281.                (use with command key to make it 10Hz)
  282.                                              (use the option key to make it tx frequency instead of rx freq)
  283.                (can also use 'Up Arrow' on keyboard)
  284.  
  285.     '\/'                            (Down Arrow) Move rx down 100 Hz
  286.                                              (use with shift key to make it 1kHz)
  287.                (use with command key to make it 10Hz)
  288.                                              (use the option key to make it tx frequency instead of rx freq)
  289.                (can also use 'Down Arrow' on keyboard)
  290.  
  291.  'TLock'       Tuning Lock: when 'on' or depressed (default), adjusting the tx
  292.                frequency
  293.                automatically adjusts the rx frequency (either inverting of
  294.                non-inverting
  295.                based on the cmode, and adjusting the rx frequency automatically
  296.                adjusts the tx frequency (either inverting of non-inverting based
  297.                on the cmode. When 'Off' transmit and receive frequencies can be
  298.                adjusted independently.
  299.  
  300. 'Slider'       The slider will scan quickly through about + or - 50 kHz.
  301.                Transmit frequency will track received when 'TLock' is active.
  302.                (use the option key to make it tx frequency instead of rx freq
  303.                when TLock 'Off')
  304.                MacOS 8 only, or MacOS 7.1 + with Appearance Manager installed.
  305.  
  306.  
  307.  
  308. Files (Both Simple Text editable):
  309.  
  310.     kepler.dat: Will read either format keplerian elements.
  311.  
  312.     mode.dat: This file holds all the frequency and mode info for the sats you are interested in.
  313.     
  314.     You can enter up to eight frequency and mode combinations as well as 8 beacon
  315.  frequencies and 8 CTCSS Tones (encode).
  316.  
  317.    Satellite:Mir
  318.    Uplink:   435.75000 435.74500 435.72500 437.65000 145.20000 145.98500 145.98500 145.98500
  319.    Downlink: 437.95000 437.95500 437.92500 437.65000 145.80000 145.98500 145.98500 145.98500
  320.    CMode:    1  1  1  6  1  6  6  6
  321.    Beacon:   0  0  0  0  0  0  0  0
  322.    Tone:    46 46  0  0  0  0  0  0
  323.  
  324.    Satellite:FO-20
  325.    Uplink:   145.97000 145.96000 145.95000 145.94000 145.93000 145.92000 145.97000 145.90000
  326.    Downlink: 435.82690 435.83690 435.84690 435.85690 435.86690 435.87690 435.82690 435.89690
  327.    CMode:    3 3 3 3 3 3 7 3
  328.    Beacon:   435.79410 435.79410 435.79410 435.79410 435.79410 435.79410 435.79410 435.79410
  329.    Tone:     0 0 0 0 0 0 0 0
  330.  
  331.  
  332.     CModes:
  333.  
  334.         1 FM Half Duplex:  (MIR) SAFEX repeater operation
  335.         2 FM Full Duplex:  AO-27, PacSats
  336.         3 SSB JA:          FO-20, FO-29
  337.         4 SSB B:           AO-10
  338.         5 SSB A (v/A):     RS-16
  339.         6    FM  FM Simplex:  MIR VHF
  340.   7 CW  JA           FO-20, FO-29
  341.   8 CW  B            AO-10
  342.   9 CW  A            RS-16
  343.  
  344.  Tone: See the Yaesu FT-736R Operating Manual, page 45.
  345.  
  346.  
  347.  
  348.  
  349. Registration:
  350.  
  351.   $50.00 USD AMSAT Non Members - $40.00 USD AMSAT Members
  352.  
  353.   Floppy Disk + $10.00
  354.  
  355.         Radio Amateur Satellite Corporation (AMSAT-NA)
  356.  
  357.   Attn: Martha Saragovitz,
  358.  
  359.   850 Sligo Ave.,
  360.   Silver Spring MD,
  361.   20910-4703 USA.
  362.  
  363.   Voice: (301) 589-6062    Fax: (301) 608-3410
  364.  
  365.   martha@amsat.org
  366.  
  367.   http://www.amsat.org/amsat/catalog/software.html
  368.  
  369.  
  370. Support:
  371.  
  372.   D o g   P a r k   S o f t w a r e   L t d . 
  373.                                                                  
  374.   Don Agro               Office: (416) 261-7977
  375.   8 Cliffcrest Drive,       Fax: (416) 261-4733
  376.   Toronto, Ontario.       email: dogpark@interlog.com
  377.   Canada       M1M 2K2      www: http://www.interlog.com/~dogpark
  378.  
  379. The latest version will be posted at: <http://www.interlog.com/~dogpark>
  380.  
  381.  
  382.  
  383.  
  384.